package com.example.backed.mapper;

import com.example.backed.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

@Mapper
public interface UserMapper {
    /**
     * 根据用户名查询用户信息（包含角色信息）
     *
     * @param username 用户名
     * @return 用户信息
     */
    User findByUsername(@Param("username") String username);

    /**
     * 插入用户信息
     *
     * @param user 用户信息
     * @return 影响行数
     */
    int insert(User user);

    /**
     * 插入用户角色关联
     *
     * @param userId 用户ID
     * @param roleId 角色ID
     * @return 影响行数
     */
    int insertUserRole(@Param("userId") Long userId, @Param("roleId") Long roleId);
    
    /**
     * 查询所有用户（分页）
     *
     * @param offset 偏移量
     * @param limit 限制
     * @param query 查询条件(用户名/邮箱/手机号)
     * @param role 角色筛选
     * @param status 状态筛选
     * @return 用户列表
     */
    List<User> findAll(@Param("offset") int offset, 
                        @Param("limit") int limit, 
                        @Param("query") String query, 
                        @Param("role") String role, 
                        @Param("status") String status);
    
    /**
     * 查询用户总数
     *
     * @param query 查询条件(用户名/邮箱/手机号)
     * @param role 角色筛选
     * @param status 状态筛选
     * @return 用户总数
     */
    int countAll(@Param("query") String query, 
                 @Param("role") String role, 
                 @Param("status") String status);
    
    /**
     * 根据ID查询用户
     *
     * @param id 用户ID
     * @return 用户信息
     */
    User findById(@Param("id") Long id);
    
    /**
     * 更新用户信息
     *
     * @param user 用户信息
     * @return 影响行数
     */
    int update(User user);
    
    /**
     * 更新用户状态
     *
     * @param id 用户ID
     * @param status 状态
     * @return 影响行数
     */
    int updateStatus(@Param("id") Long id, @Param("status") Integer status);
    
    /**
     * 更新用户密码
     *
     * @param id 用户ID
     * @param password 密码
     * @return 影响行数
     */
    int updatePassword(@Param("id") Long id, @Param("password") String password);
    
    /**
     * 删除用户角色关联
     *
     * @param userId 用户ID
     * @return 影响行数
     */
    int deleteUserRoles(@Param("userId") Long userId);
} 